home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / pcboard / pwrap110.zip / PCBWRAP.DOC < prev    next >
Text File  |  1996-04-10  |  4KB  |  97 lines
  1.  
  2.  
  3.  
  4.                                PCBWrap v1.10
  5.              DOS utility: PCBoard filelist offline reformatter
  6.                    Freeware, copyright (c) April 10, 1996
  7.                                      by
  8.                            David Daniel Anderson
  9.                                  Reign Ware
  10.  
  11.                   ** READ REIGNWAR.TXT FOR LEGAL TERMS **
  12.  
  13.  
  14.  
  15. PCBWrap reformats downloaded PCBoard directory list "short" (45 character)
  16. description lines into "long" lines (78 characters [or more]).  Make the
  17. lists easier to read and smaller.  See "visual example" below.
  18.  
  19.                           ****** WARNING!!! ******
  20.   PCBwrap overwrites the input file, so make sure that you either work on
  21.  a copy of your file(s), or you know what you are doing before you start.
  22.  (Use PCBWrap filename 31:1 to return them to approximate original style.)
  23.                           ****** WARNING!!! ******
  24.  
  25. Usage:  PCBWrap file(s)_to_wrap [prepipe[:postpipe]]
  26. SET-able DOS Environment variables: MARGIN, NOSTRIP
  27.  
  28. Example: PCBWrap uploads.dir 31:2
  29.  
  30. The first command line parameter is the mandatory filename (or names),
  31. which may include the DOS wildcards of "*" and "?"  (e.g. WIN*.*).
  32.  
  33. The second command line parameter is an optional LEFT margin specification.
  34.  
  35.   Background:  The left margin of the FILE is composed of at least one space
  36.   (prepipe), followed by a pipe symbol (|), and, finally, at least one more
  37.   space (postpipe).
  38.  
  39. Similarly, the left margin specification is composed of a prepipe value, a
  40. _COLON_ (:), and a postpipe value.  Prepipe and postpipe are specified as
  41. numbers in the range of 1 to 79, whose -sum- must not exceed 80 characters.
  42.  
  43. You need not specify either a prepipe or postpipe length, but you can not
  44. specify a postpipe length without including a prepipe length.  Remember to
  45. use a colon (:) as a delimiter if you specify both.
  46.  
  47. The DOS env. var. "margin" allows the RIGHT margin to be changed from the
  48. default of 78 to anything in the range of 47 to 125 (invalid values will be
  49. changed to 78).  Use "SET margin=nn", where "nn" is the value (such as 90).
  50.  
  51. If the "margin" is SET in DOS, all values must be set so that the following
  52. equation is true:
  53.  
  54.     right margin - left margin <= 44
  55.  
  56.     where right margin is the value of "margin" (or 78),
  57.     and left margin is the sum of prepipe+postpipe+1.
  58.  
  59. The DOS env. var. "nostrip" overrides the default feature of PCBWrap which
  60. removes the "Uploaded by:...", "Files:...", and other lines which are often
  61. present.  Set "NOSTRIP=true" to prevent these lines from being stripped.
  62.  
  63. Starting with version 1.06, PCBWrap removes control codes and box/ line
  64. drawing characters from file descriptions.  This feature can not be
  65. disabled.
  66.  
  67. Visual example:
  68. ---------------
  69. >> The command "PCBWrap uploads.dir" changes this:
  70.  
  71. PWRAP106.ZIP    19081  08-09-94  PCBWrap v1.06, DOS utility: PCBoard filelist
  72.                                  offline reformatter. Freeware (c) 1994
  73.                                  [94/08/09] by DDA - Reign Ware. W/ Pascal
  74.                                  source. New: faster & more powerful.
  75. >> to this:
  76.  
  77. PWRAP106.ZIP    19081  08-09-94  PCBWrap v1.06, DOS utility: PCBoard filelist
  78.  | offline reformatter. Freeware (c) 1994 [94/08/09] by DDA - Reign Ware. W/
  79.  | Pascal source. New: faster & more powerful.
  80.  
  81. Try PCBWrap filelist 32:1 for an easy to read filelist (with hanging
  82. indents).  To minimize file size, use PCBWrap filelist [1:1].
  83.  
  84.  
  85. Included files:
  86. --------------
  87. FILE_ID.diz   - Description In Zip (brief description, used by PCBoard)
  88. PCBWrap.doc   - this documentation file
  89. PCBWrap.exe   - program to run
  90. PCBWrap.pas   - source code and revision history
  91. PCBWrap.cmp   - a comparison between PCBWrap and COPYDESC
  92. Reignwar.txt  - legal terms
  93. RW_progs.lst  - list of other Reign Ware programs
  94.  
  95. PCBoard is a registered trademark of Clark Development Corp. (I think.)
  96.  
  97.